﻿<html>
  <head>
    <meta name="source" content="http://www.terrainformatica.com/wiki/doku.php?id=h-smile:built-in-behaviors:checkbox"/>
    <meta name="generator" content="h-smile:richtext"/>
  </head>
<body>
  <h1>behavior:check</h1>
  <p>标准的复选框行为。它可以应用到任何需要切换:checked状态的DOM元素上。</p>
  <h2>元素</h2>
  <p>默认情况下，应用了该行为的元素有:</p>
  <ul>
    <li><code>&lt;input type=&quot;checkbox&quot;&gt;</code> - 标准的HTML行内复选按钮;</li>
    <li><code>&lt;button type=&quot;checkbox&quot;&gt;</code> - Windows外观的复选按钮, 请这样使用它<code>&lt;button type=checkbox&gt;caption&lt;/button&gt;</code>.</li></ul>
  <h2>示例</h2>
  <div>
    <button type="checkbox" >复选框1</button> 
  	<button type="checkbox" checked >复选框2</button> 
    <button type="checkbox" mixed >复选框3</button> 
  </div>
  <h2>属性</h2>
  <p>该行为需要知道的属性:</p>
  <ul>
    <li><code>checked</code> - 如果提供了该属性，则将会初始化元素的运行期状态添加<em>checked</em>标志。</li>
    <li><code>mixed</code> - 如果提供了该属性，则该元素将有三种状态：选中(true)、未选中(undefined)、部分选中(undefined)。</li>
    <li><code>name=&quot;name&quot;</code> - 标准的<em>name</em>属性 - from表单上一个input元素的名称。</li>
    <li><code>value=&quot;...&quot;</code> - 标准的value属性(用于<code>behavior:form</code>)。</li></ul>
  <h2>事件</h2>
  <p>除了标准事件集(鼠标、按键、聚焦)外，该行为还生成:</p>
  <ul>
    <li>BUTTON_STATE_CHANGED 事件 - 当按钮修改了它的选中状态时生成该事件。该事件为异步事件。</li>
    <li>BUTTON_PRESS 事件 - 当鼠标在该按钮上按下或当按钮聚焦时按下<code>空格</code>键时产生该事件。该事件为异步事件。</li></ul>
  <h2>value</h2>
  <p><code>true/false</code>, 反映按钮的当前状态是否包含<code>:checked</code>标志。</p>
  <h2>方法</h2>
  <p>N/A - 该行为没有引入任何特有的方法。</p>
  <p></p>
</body>
</html>